Keyboard

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Keyboard-Schnittstelle der Keyboard API bietet Funktionen, die Tastaturlayout-Karten abrufen und das Erfassen von Tastendrücken von der physischen Tastatur umschalten.

Eine Liste gültiger Code-Werte finden Sie in der Spezifikation UI Events KeyboardEvent code Values.

EventTarget Keyboard

Instanz-Eigenschaften

Erbt auch Eigenschaften von ihrer Elternschnittstelle, EventTarget.

Instanz-Methoden

Erbt auch Methoden von ihrer Elternschnittstelle, EventTarget.

Keyboard.getLayoutMap() Experimentell

Gibt ein Promise zurück, das mit einer Instanz von KeyboardLayoutMap aufgelöst wird, die ein Map-ähnliches Objekt mit Funktionen zum Abrufen der Strings ist, die mit bestimmten physischen Tasten verbunden sind.

Keyboard.lock() Experimentell

Gibt ein Promise zurück, das sich auflöst, nachdem das Erfassen von Tastendrücken für eine oder alle Tasten auf der physischen Tastatur aktiviert wurde.

Keyboard.unlock() Experimentell

Entsperrt alle Tasten, die durch die Methode lock() erfasst wurden, und gibt synchron zurück.

Beispiel

Tastaturzuordnung

Das folgende Beispiel zeigt, wie man den orts- oder layoutspezifischen String erhält, der der Taste entspricht, die der 'W'-Taste auf einer englischen QWERTY-Tastatur entspricht.

js
if (navigator.keyboard) {
  const keyboard = navigator.keyboard;
  keyboard.getLayoutMap().then((keyboardLayoutMap) => {
    const upKey = keyboardLayoutMap.get("KeyW");
    window.alert(`Press ${upKey} to move up.`);
  });
} else {
  // Do something else.
}

Tastatursperre

Das folgende Beispiel erfasst die Tasten W, A, S und D>, indem lock()` mit einer Liste aufgerufen wird, die den Schlüsselattributwert für jede dieser Tasten enthält:

js
navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);

Dies erfasst diese Tasten unabhängig davon, welche Modifikatoren mit dem Tastendruck verwendet werden. Angenommen, ein Standard-QWERTY-Layout der Vereinigten Staaten ist in Verwendung, stellt die Registrierung KeyW sicher, dass W, Shift+W, Control+W, Control+Shift+W, und alle anderen Tastenmodifikator-Kombinationen mit W an die App gesendet werden. Das Gleiche gilt für KeyA, KeyS und KeyD.

Spezifikationen

Specification
Keyboard Map
# keyboard-interface
Keyboard Lock
# keyboard-interface

Browser-Kompatibilität